Magnum One

home *** CD-ROM | disk | FTP | other *** search

/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d22 / ds400a.arc / DS_USERS.MAN < prev next >

Wrap

Text File | 1990-06-29 | 76.6 KB | 1,594 lines

DIRECTORY SCANNER (tm) Ver 4.00 Copyright (c) 1986-1990 All Rights Reserved by Nat Martino 501 W. Vineyard Ave #514 Oxnard, CA 93030 (805) 485-6340 -> PRIOR TO 1 MAY 1991 <- PO Box 21284 Concord, CA 94521 (415) 682-3618 -> AFTER 1 MAY 1991 <- T A B L E O F C O N T E N T S DIRECTORY INDICATOR MOVEMENT . . . . . . . . . . . . . . 1 Directory Movement with Arrow Keys . . . . . . . . . . 1 Linking Directories to Numbers . . . . . . . . . . . . 2 FILE INDICATOR MOVEMENT . . . . . . . . . . . . . . . . . 3 COMMANDS . . . . . . . . . . . . . . . . . . . . . . . . 4 Attribute Tagged Files . . . . [ A ] . . . . . 4 Attribute Directory . . . . . . [ ctrl-A ] . . . . . 4 Command Entry . . . . . . . . . [ C alt-C ] . . . . . 5 Drive Change . . . . . . . . . [ D ] . . . . . 5 Delete Tagged Files . . . . . . [ alt-D ] . . . . . 6 Directory Tree Modifications. . [ ctrl-D ] . . . . . 6 Edit Indicated File . . . . . . [ E alt-E ] . . . . . 9 Edit Defaults . . . . . . . . . [ ctrl-E ] . . . . . 10 Find File . . . . . . . . . . . [ F ] . . . . . 11 Free Bytes on Other Drive . . . [ alt-F ] . . . . . 12 Help Menu . . . . . . . . . . . [ ? ] . . . . . 12 Copy Tagged Files . . . . . . . [ K ] . . . . . 12 Color Changes . . . . . . . . . [ alt-K ] . . . . . 13 List Indicated File . . . . . . [ L alt-L ] . . . . . 14 Limits of Program . . . . . . . [ ctrl-L ] . . . . . 15 Move Tagged Files . . . . . . . [ M ] . . . . . 15 25 43/50 Line Mode Toggle . . . [ alt-M ] . . . . . 15 Print Tagged Files . . . . . . [ P alt-P ] . . . . . 16 Rename Indicated File . . . . . [ R ] . . . . . 16 Rescan Directory . . . . . . . [ alt-R ] . . . . . 16 Refresh Screen . . . . . . . . [ ctrl-R ] . . . . . 17 Split Screen . . . . . . . . . [ S ] . . . . . 17 Select & Sort . . . . . . . . . [ alt-S ] . . . . . 17 Tag File . . . . . . . . . . . [ T ] . . . . . 18 Tag All Files . . . . . . . . . [ alt-T ] . . . . . 18 Control Tagging . . . . . . . . [ ctrl-T ] . . . . . 18 Untag File . . . . . . . . . . [ U ] . . . . . 19 Untag All Files . . . . . . . . [ alt-U ] . . . . . 19 Utility Tree Dump . . . . . . . [ ctrl-U ] . . . . . 19 Volumn ID Toggle . . . . . . . [ ctrl-V ] . . . . . 19 eXecute File . . . . . . . . . [ X alt-X ] . . . . . 20 Switch/Flip Screen . . . . . . [ + ] . . . . . 20 MACROS . . . . . . . . . . . . . . . . . . . . . . . . . 21 EXIT PROGRAM . . . . . . . . . . . [ F9 ] . . . . . 24 LICENSING & REGISTRATION . . . . . . . . . . . . . . . . 24 WARRANTY & DISCLAIMER . . . . . . . . . . . . . . . . . . 25 - i - +-------------------------------------+ ============| DIRECTORY INDICATOR MOVEMENT |=========== +-------------------------------------+ The Function Keys F1 thru F8 allow the user to move the directory highlighter from one directory to another. Moving the highlighter from directory to directory does not change the user into the newly highlighted directory until the user strikes the carriage return [CR] key. The directory function keys do the following: F1 - Move the directory highlighter backward/up to the previous directory. F2 - Move the directory highlighter forward/down to the next directory. F3 - Move the directory highlighter up the tree display half as many directories as are currently displayed. F4 - Move the directory highlighter down the tree display half as many directories as are currently displayed. F5 - Move the directory highlighter to the root directory. F6 - Move the directory highlighter to the very last directory. F7 - Scroll up the display of the directory structure. F8 - Scroll down the display of the directory structure. ************ You need to hit the * REMEMBER * carriage return [CR] to ************ change/enter a directory. If the user is in the split screen mode (see "S" option) the active directory is altered as indicated above with the F1 thru F8 and <CR> keys. To alter the directory in the non- active display, use the <Ctrl-PgUp>, <Ctrl-PgDn> and <Ctrl-CR> keys. DIRECTORY MOVEMENT WITH ARROW KEYS - The user has an alternate means of moving the directory highlighter through the use of the arrow keys. Normally the arrow keys are used to move amongst the files of a directory, however; with the help of the space bar acting as a toggle key, the arrow keys can move the directory highlighter as well. This can be handy for those users possessing keyboards with function keys along the top of the keyboard which makes it difficult to use for directory movement. - 1 - The SPACE bar is used as a toggle to switch the definition of the arrow keys from file movement to directory movement and back again. A small left pointing arrow will appear midway down the border between the directory screen and the file screen when the arrow keys work on directory movement. When no left arrow appears in the border between the screens, the arrow keys work on file movement. Users that desire preventing the SPACE bar from acting as a toggle key (and accidently switching the arrow key definitions) can lock out the SPACE bar toggle feature by selecting the "CTRL-E" (edit defaults) option and setting the appropriate default. LINKING DIRECTORIES TO NUMBERS OPTION - The user may link a directory to a number (1 thru 9) or alt-number (alt-1 thru alt-9) key sequence. After a directory is so linked, selecting the number or alt-number sequence will highlight the desired directory. To enter the directory the user may still be required to hit the return/enter key. The user may display and/or change directory-number links by selecting the "0" key or "alt-0" key sequence. The display presented will allow changes to the links by highlighting the desired directory with F1 thru F8, the desired number with Up/Dn Arrows, and then using the Ins key to assign a link, or the Del key to delete a link. If changes are made, the user is prompted to chose whether the startup defaults file should be permanently modified. Also from this display the user may elect to switch directly to another displayed directory without making any changes to displayed links. When using the directory link option to switch highlighted directories the drive id of the source and destination directories is significant. If the drive id of the source or current directory is different from the destination or future directory then not only is the new directory highlighted but the user is also placed in the new directory and presented with the listing of files in that new directory on the right side of the display. If the drive id of the source and destination are the same then the new directory is highlighted but the user remains in the old directory and the file listing on the right side of the display remains unchanged. To enter the new directory a return/enter must be entered. "TAB <ltr>" OPTION - Depressing the TAB key followed by a letter will move the highlighted directory to the first directory whose first letter of its full pathname (excluding drive id, ie: "c:\") is equal to or greater than the specified letter. Currently there is a limitation of a maximum of 150 directories for any one drive. Exceeding this limit will result in an error message. See "CTRL-L" option. - 2 - +---------------------------+ ================| FILE INDICATOR MOVEMENT |================= +---------------------------+ Upon entering a directory that contains one or more files, the first file in the directory is marked with 2 small triangluar indicators, one on each side of the file name. This indicates which file is the current "indicated file", and further file information about this file is displayed at the bottom of the display screen. To change the "indicated file" the file indicators are moved from file to file through the use of the cursor arrow keys on the numeric keypad. The arrow and related keys work as follows: Up Arrow Key - Move to the previous file Down Arrow Key - Move to the next file Left Arrow Key - Move to the file in the column to the left Right Arrow Key - Move to the file in the column to the right Home Key - Move to the first file on the display screen End Key - Move to the last file on the display screen PgUp Key - Display previous page of file names PgDn Key - Display next page of file names The PgUp/PgDn keys are active only when the currently displayed directory has more files than can fit on a single screen/page. "TAB TAB <ltr>" OPTION - Depressing the TAB key twice followed by a letter will change the "indicated file" to be the first file whose first letter of its name is equal to or greater than the specified letter. Currently there is a limitation of a maximum of 300 files per any one directory. Exceeding this limit will result in an error message. See "CTRL-L" option. - 3 - +---------------------------+ ================| COMMANDS |================= +---------------------------+ +-----------------------------+ +----------+ -----| ATTRIBUTE TAGGED FILES |---------| "A" |----- +-----------------------------+ +----------+ This option allows the user to change 4 of the attribute bits on all files that are tagged. Depressing "A" with no files tagged will allow the user to work only on the current indicated file. Activation of this option will allow the user to turn on/off the read-only bit, the system bit, the hidden bit and the archive bit by toggling the "r", "s", "h" and "a" keys respectively. Changing the file's attribute bits only takes effect when the "M" key (for Modify) is depressed. The user should toggle the attribute select keys ("r", "s", "h" & "a") to the desired states, then hit the "m" key to activate the desired changes. This option will also allow the user to tag or untag certain files based on the current status of the attribute bits. The user should set/specify the desired attribute bits to test each file, then select <CTRL-T> or <CTRL-U> for tagging or untagging based on the specified bits. The <SPACE> bar can be used to toggle the logical AND/OR condition which applies to this control tagging option. The option will also allow the use of <Alt-T> and <Alt-U> for tagging or untagging all files. Additionally single file tagging or untagging is allowed with the "T" and "U" keys. +-----------------------------+ +----------+ -----| ATTRIBUTE DIRECTORY |---------| "Ctrl-A" |----- +-----------------------------+ +----------+ This option allows the user to change the same 4 file attribute bits that Option A (above) changes, except this option works on the attribute bits of the highlighted directory. The significance of changing the read-only, system, and archive bits of a directory is unknown. Turning the hidden bit of a directory on will hide the directory from the normal DOS "dir" command. The DS program can see the directory regardless of the condition of the hidden bit. The user may want to hide a directory so that other people that use the same machine do not rummage through the hidden directory. This assumes the other users do not know or have access to the DS or other programs that show the directory regardless of the hidden bit. The user is prohibited from changing the attribute bits on the root directory of any drive. All sub-directories are fair game. - 4 - Upon selecting this option, the attribute bit settings show the current status of the highlighted directory. The user can use the F1 thru F8 keys to show the bits settings on other directories. +-----------------------------+ +------------+ -----| COMMAND ENTER |-------|"C" "Alt-C"|----- +-----------------------------+ +------------+ The command entry option allows the user to enter any command they would enter at the normal DOS command prompt. Whatever is entered by the user is passed on to a second copy of "command.com". Upon depressing the "c" or "alt-c" key the display screen will be cleared and the following message appear: To return to DS - Enter only a carriage return The DOS command line prompt will be the current path followed by a triangle symbol pointing to the right. Users may enter as many commands in sequence as they desire, returning to DS by entering only a carriage return. This option will allow the user to interface with DOS command stack programs such as "CED", and with DOS keyboard enhancement programs such as "Newkey". The "c" option will process one or more commands while the DS program stays resident in memory. The "alt-c" option will process the desired command while overlaying the DS program. Upon termination of the "alt-c" option the DS program will be reloaded from disk. The "alt-c" option is slower to reload/restart DS but useful in systems that are tight on memory. Upon reloading DS the "alt-c" option should retain the same current "indicated file"; however, all tagging of files will be lost. The edit defaults option ("Ctrl-E") contains a selection item that will instruct the program to automatically use the "alt-c" option even if the "c" option was selected if the amount of available memory is less than a specified value. The specified amount of memory is user tunable. Selecting 590k for the memory limit will force the program to always use the overlay option. Selecting 10k for the memory limit will prevent the overlay option from being used in place of the normal option. +-----------------------------+ +----------+ -----| DRIVE CHANGE |---------| "D" |----- +-----------------------------+ +----------+ The drive change option allows the user to switch to a different default drive and display the directory structure information of the new drive. When switching off a hard disk, - 5 - all directory structure information about that drive and other pertinent program information (ie: current colors) is first copied to the "ds_globl.log" and "ds_drv_?.log" files. This is done so that when switching back to that hard disk it is not necessary to do a rescan of the entire disk to recover the disk directory structure information. The user can specify which drives the program will maintain "log" files on through the use of the "Ctrl-E" option. This option will also allow the user to change to a different log file of the same or different drive. Once the user presses "d" to activate this option they may then enter up to 4 characters for the specified destination drive. If the user specifies the destination drive of "c", they will be switched to the C: drive using the "ds_drv_c.log" (default) log file. If the user specifies the destination drive of "c123", they will be switched to the C: drive using the "ds_drv_c.123" log file. Note that neither a ":" nor a "." is used. If the user switches to a drive via a log file other than the default (".log") then the default log file is overwritten by the specified log file so that it becomes the current default log. +-----------------------------+ +----------+ -----| DELETE TAGGED FILES |---------| "Alt-D" |----- +-----------------------------+ +----------+ The delete tagged files option will allow the user to delete those files that have been tagged (see Option "T" below). This option will first request a confirmation that the user really wants to delete all those files marked. THE DEFAULT CONFIRMATION RESPONSE IS "Y", SO DEPRESSING ANY KEY EXCEPT "N" (and ESC) WILL DELETE ALL TAGGED FILES. +-----------------------------+ +----------+ -----| DIRECTORY TREE MODIFICATION |---------| "Ctrl-D" |----- +-----------------------------+ +----------+ The directory modification option will allow the user to add/delete directories and change the name of specified directories. Additionally, this option will enable the user to modify the tree display without adding or deleting directories on the hard disk, and to save to or read from disk "log" files of the specified drives. Once the option is selected, the 7 sub-options are displayed. Add Directory - This option will create a new directory on the hard disk and modify the tree display to include the new directory. 1. The user must highlight (using F1-F8) the PARENT directory where the new directory will be added, press the "a" key, and then enter the name of the new - 6 - directory. 2. The addition is denied if the current number of directories is already at the max directory limit. 3. The new directory name must be valid. 4. The new directory name must have a full pathname less than 64 characters and a screen print name less than 40 characters. Delete Directory - This option will delete the specified directory from both the hard disk and the tree display. 1. The user must highlight (using F1-F8) the directory which they desire to delete and then press the "d" key. 2. Deletion is denied if the user is currently in the specified directory (ie: right side file display matches left side highlighted directory). 3. Deletion is denied if the highlighted directory is not empty (ie: has subdirectories or files still attached). 4. Deletion is denied if the highlighted directory is the root directory. Change Name - This option will allow the user to change the name of a directory on both the hard disk and tree display. 1. The user must highlight (using F1-F8) the directory which they desire to change, press the "c" key, and then enter the new directory name. 2. The new directory name must be valid. 3. The new directory name must have a full pathname less than 64 characters and a screen print name less than 40 characters. Additionally, the subdirectories of the directory in question must not exceed the 64 character pathname as a result of this name change. 4. The change name option only works on PC/MS DOS 3.0+. DOS 2.x does not support changing of directory names. Unmount Subdirectories - This option will allow the user to delete subdirectories on the tree display without deleting them from the hard disk. It will enable the user to make room for other directories in the tree display should they be confronting the program limits of 150 directories per drive. This option will also check to insure that the highlighted directory is really valid (out on the disk) and display an error message if it is not valid and should be unmounted. 1. The user must highlight (using F1-F8) the directory which they desire to delete, then press the "u" key. 2. The root directory cannot be unmounted. - 7 - Mount Subdirectories - This option will allow the user to add to the tree display subdirectories which are already present on the hard disk. 1. The user must highlight (using F1-F8) the PARENT directory of the new subdirectories, then press the "m" key. Write Log File - This option will allow the user to write out to disk a "log" file of the current drive as the current tree display represents. 1. The user need only press the "w" key and then enter the 3 letter filename extension for the file. 2. The user should not specify a filename extension of "log" as the program uses that extension as the default log file for the specified drive. 3. Note that the user can only specify 3 characters for the filename extension and that the "." is already provided by the program. 4. This write option will not only write a new log file out to disk but also cause a "switch" to that new log file. The ".ext" will change in the top border after the drive identifier to indicate such a switch. Switch Log File - This option will allow the user to switch to a different "log" file of the current drive which may radically change the current tree display. 1. The user need only press the "s" key and then enter the 3 letter filename extension for the file. 2. Note that the user can only specify 3 characters for the filename extension and that the "." is already provided by the program. Log Filename Format = ds_drv_X.YYY where X = letter "a" thru "z" indicating which drive this log file represents. YYY = "log" - default log file for this drive or = "any other valid 3 char" - a special log file for the specified drive created and maintained by the user. Log File Rules: 1. The "ds_drv_X.log" file is always the current and default log file for specified drive X. (X = letter "a" thru "z") 2. When exiting the Directory Mod (ctrl-d) routine the ".log" file for the current drive is automatically updated on the disk to reflect the current displayed directory tree. 3. When exiting the Directory Mod (ctrl-d) routine a - 8 - drive log file with an extension other than ".log" is updated automatically if the extension is shown in the top border after the drive identifier. 4. If drive X has 2 log files (extensions ".log" & ".123") and the user currently on drive Y wishes to return to drive X, they may specify either of the following to the Drive Change ("d") command: a) "X" - to change to drive X using ".log" as the drive log. b) "X123" - to change to drive X using ".123" as the drive log. This input will result in the ".log" file being written over by the ".123" file. Upon completion of any of the above options the program will make necessary adjustments to the directory tree display and allow the user to make additional modifications. To terminate the directory modification option, hit the ESC key. Upon terminating this option with with the ESC key, the program automatically updates the current drive's ".log" file to reflect the current tree display. Additionally, if the user is currently using a log file other than ".log" (ie: .123) and that extension is shown in the top border after the drive identifier, then the specified log file (.123) will also be updated to reflect the current tree display. +-----------------------------+ +------------+ -----| EDIT INDICATED FILE |-------|"E" "Alt-E"|----- +-----------------------------+ +------------+ The edit option will allow the user to edit the current "indicated file". The user must supply and identify the desired editor to the DS program. The DS program does not provide an editor of its own, but simply attempts to execute a ".com" or ".exe" file that has been defined by the "Ctrl-E" option as the default editor. The user should specify a full pathname for the desired editor with the "Ctrl-E" option. If the user has not previously defined their own favorite editor to the DS program, the program will attempt to execute a file by the name of "edit.com", "edit.exe", or "edit.bat". Upon successful execution of the defined editor, the DS program passes to it the name of the current indicated file. Upon termination of the editing process, the DS program resumes where it left off. The "e" option will edit the indicated file while the DS program stays resident in memory. The "alt-e" option will edit the indicated file while overlaying the DS program. Upon termination of the "alt-e" option the DS program will be reloaded from disk. The "alt-e" option is slower to reload or restart DS but useful in systems that are tight on memory. Upon reloading DS the "alt-e" option should retain the same current "indicated file"; however, all tagging of files will - 9 - be lost. The edit defaults option ("Ctrl-E") contains a selection item that will instruct the program to automatically use the "alt-e" option even if the "e" option was selected if the amount of available memory is less than a specified value. The specified amount of memory is user tunable. Selecting 590k for the memory limit will force the program to always use the overlay option. Selecting 10k for the memory limit will prevent the overlay option from being used in place of the normal option. It is highly recommended that the user obtain and execute the "DPATH" program (found on most RBBS boards) in their autoexec.bat file. DPATH is to data files what PATH is to executable files. With DPATH in effect, your editor will be able to find supporting files even though your current directory may not be the directory where your editor and the support files reside. Users who have DOS 3.2 or later should use the "APPEND" command which accomplishes the same results as the DPATH program. +-----------------------------+ +----------+ -----| EDIT DEFAULTS |---------| "Ctrl-E" |----- +-----------------------------+ +----------+ The Edit Defaults option will allow the user to define 6 default parameters. The user can specify the default editor (depressing the "E" key), the default lister ("L" key), and the default print ("P" key) programs. The initial defaults for the editor, lister, and printer are "edit", "list", and "print", but may be changed by the user. Upon selection of this option the user is presented with a display of the current defaults and the command keys to effect changes. The user should specify A COMPLETE PATHNAME for the desired editor, lister, and print programs. For example, if the desired editor is "list.com" in the "dos" directory on the "c:" drive, then specify "c:\dos\list" rather than just "list". Failure to specify a complete pathname will result in the "alt-e", "alt-l", and "alt-p" options failing to execute and presenting the following (rather misleading) DOS error message: "run-time error R6005 -not enough memory on exec" This option will also allow the user to specify which drives the program will maintain "log" files. Log files are maintained on hard disks so the program will not rescan the entire disk each time on startup to determine the directory structure information. This option will additionally allow the user to specify an - 10 - amount of memory whereupon the program will automatically switch from using the "e", "l", "x", "c" and "p" options to using the respective overlay versions of the same options. Editing these memory amounts is accomplished by selecting either an upper or lower case "e", "l", "x", "c", or "p". For example, to decrease the specified memory amount for the "c" option, depress the lowercase "c" key. To increase the specified memory for the "c" option, depress the uppercase "C" key. The final default which this option can set is whether the space bar will toggle the use of the arrow keys between file and directory movement. Use the space bar to toggle the default parameter settings. +-----------------------------+ +----------+ -----| FIND FILE |---------| "F" |----- +-----------------------------+ +----------+ The find option will allow the user to search the current default drive for a specified file. The user provides the name of the file, which can include the "*" and "?" wildcard specifiers. The find option will then commence a search of all directories starting from the root directory. When a matching file is found in a directory, the program stops in that directory and DISPLAYS ONLY THOSE FILES OF THE DIRECTORY THAT MATCH THE SPECIFIED STRING. This option only stops once in each directory. Any additional files that match (which is likely with "*" and "?") will also be displayed along with the "indicated file". Once the program has halted in a directory that has a matching file the following options are available: Arrow Keys \ Home / End } - Work as they normally do PgUp / PgDn / 'L' or 'l' Key - Will list the indicated file Note: Directory movement keys F1-F8 do not work here. The user has 3 additional options to continue/terminate: F2 Key - Continue searching directories. [CR] Key - Terminate search option in the currently displayed directory. ESC Key - Terminate search option & return user to the original directory from which the option was started. - 11 - If "F2" is chosen, upon completion of the final directory the user is placed in the original directory from which the find option was activated. Note: The find option disregards the user's current select & sort options (see ALT-S) while searching for matching files. During execution, the find option uses a select criteria of the specified search string and sorts files by ascending filename. Therefore, display of directories which contain matching files will show only those filenames of matching files even though there may be additional files in the directory. Upon termination of this option, the user's original select & sort options are reinstated. If, however, the user exits this option through the use of the CR (current directory) key, there is the possibility that the file the user just found will disappear if the original file select criteria does not match the file just found. Confusing isn't it. +-----------------------------+ +----------+ -----| FREE ON OTHER DRIVE |---------| "Alt-F" |----- +-----------------------------+ +----------+ This option will allow the user to find out the available space (free bytes) of any drive without having to switch off the current drive. This option would most appropriately be used when tagging files on the current drive to copy to another drive. In this way the user can get a rough estimate as to how many files can be tagged and copied to the other drive. The number of free bytes on the other drive will be displayed in the lower right corner of the box border, just above the display of the number of bytes tagged on the current drive. Due to the nature of file space allocation by DOS (in clusters of varying sizes on different media), you will not be able to copy as many bytes from one media to the other media as specified in this option. In other words, expect to copy fewer than the number of free bytes displayed by this option. +-----------------------------+ +----------+ -----| HELP MENU |---------| "?" |----- +-----------------------------+ +----------+ The help menu will display a one page summary of all available options. Expanded context-sensitive help is available by depressing the F10 key. +-----------------------------+ +----------+ -----| COPY TAGGED FILES |---------| "K" |----- +-----------------------------+ +----------+ The copy tagged files option will copy those files that are tagged (see Option "T" below) to a specified directory. The user will specify the desired destination directory. If - 12 - the user desires to make a second copy of a file in the same directory, specify only the new name of the file. If the user specifies only a drive specification such as "a:", the program will copy the tagged files to the current directory on that drive. If the user does not specify a destination directory but simply enters a carriage return, the program will copy the tagged files to the directory which is currently highlighted. When choosing this last method of specifying the destination directory, prior to entering the carriage return the user may change the highlighted directory with the use of the F1 thru F8 keys. The program will not allow the user to copy a file or files to the same directory without specifying a new filename. In other words, no copy will take place if the user simply enters a carriage return and the highlighted directory also happens to be the current directory. This prevents the system from trying to copy a file onto itself and consequently clobbering itself. If in the split screen mode, users can specify the destination directory for a copy command with an "*" if the desired destination directory is the highlighted directory on the "other display" of the split screen display mode. The "*" can also be used if in the full screen mode and the desired destination is the highlighted directory in the other full screen "FLIP" mode. +-----------------------------+ +----------+ -----| COLOR CHANGE |---------| "Alt-K" |----- +-----------------------------+ +----------+ The DS program will allow the user with a color/graphics monitor to change the color of the foreground, background and display border. To enable these color changes the user first selects the ALT-K option, whereupon the following keys are used: F1 Key - Change/Increment the display foreground color. The foreground cycles thru 16 colors. F2 Key - Change/Increment the display background color. The background cycles thru 8 colors. F3 Key - Change/Increment the display border color. The border cycles thru 8 colors. F4 Key - Modify the defaults startup file "ds_prog.def" so that current selected colors will be used on future initializations of the program. F5 Key - Modify the default colors used when not within the DS program. This option requires the presence of the ansi.sys device driver. - 13 - F6 Key - Modify the color/mono attributes on the display to conform with a monochrome display. This option might be necessary should the defaults file contain color attributes which are undesirable (ie: underline) for a monochrome display. To exit the color change option, depress the Return or Escape key. +-----------------------------+ +------------+ -----| LIST FILE |-------|"L" "Alt-L"|----- +-----------------------------+ +------------+ The list option will allow the user to list the contents of the current "indicated file". The user must supply and identify the desired lister program to the DS program. The DS program does not provide a lister program of its own, but simply attempts to execute a ".com" or ".exe" file that has been defined by the "Ctrl-E" option as the default lister. The user should specify a complete pathname for the desired lister program with the "Ctrl-E" option. If the user has not previously defined a lister program to the DS program, the program will attempt to execute a file by the name of "list.com", "list.exe", or "list.bat". If the user does not have a lister program they should create a "list.bat" with "type %1" and "pause" as the only 2 lines in the file which "ctrl-e" maintains as the lister file. This way the file will be listed via the DOS "type" command. An outstanding lister program by Vernon D. Buerg is available in the "shareware" environment which is highly recommended for your use. The "l" option will list the indicated file while the DS program stays resident in memory. The "alt-l" option will list the indicated file while overlaying the DS program. Upon termination of the "alt-l" option the DS program will be reloaded from disk. The "alt-l" option is slower to reload or restart DS but useful in systems that are tight on memory. Upon reloading DS the "alt-l" option should retain the same current "indicated file"; however, all tagging of files will be lost. The edit defaults option ("Ctrl-E") contains a selection item that will instruct the program to automatically use the "alt-l" option even if the "l" option was selected if the amount of available memory is less than a specified value. The specified amount of memory is user tunable. Selecting 590k for the memory limit will force the program to always use the overlay option. Selecting 10k for the memory limit will prevent the overlay option from being used in place of the normal option. - 14 - +-----------------------------+ +----------+ -----| LIMITS OF THE PROGRAM |---------| "Ctrl-L" |----- +-----------------------------+ +----------+ This option will show the user the limits of the current "DS.EXE" program. Normally the user should never need to exercise this option. However, should one of the program limits be exceeded, an alarm will sound and a message will be displayed that states "Exceeded Program Limits". The user can then use this option to determine which program limit was exceeded. Hopefully the program will continue to operate, disregarding the directories or files that exceeded the program limits. As the size of the data structures supporting this program are determined at compile time (vice execution time), currently the only remedy for exceeding the program limits is to either rearrange your directory/file structure to conform to the program limits, or contact the author for another copy of the program with limits extended to values more appropriate to your particular system. +-----------------------------+ +----------+ -----| MOVE TAGGED FILES |---------| "M" |----- +-----------------------------+ +----------+ The move tagged files option allows the user to move those files tagged (see Option "T" below) to another directory on the same or a different drive. The user can either specify the desired destination directory or enter simply a carriage return. If the user enters only a carriage return, the program will move all the tagged files to the directory which is currently highlighted. When choosing this method of specifying the destination directory, the user may change the highlighted directory with the F1 thru F8 keys prior to entering the carriage return. Additionally, the highlighted directory must be different from the current directory (the one in which the tagged files are in) for this method of entering only a carriage return to work. If in the split screen mode, users can specify the destination directory for a move command with an "*" if the desired destination directory is the highlighted directory on the "other display" of the split screen display mode. The "*" can also be used if in the full screen mode and the desired destination is the highlighted directory in the other full screen "FLIP" screen. +-----------------------------+ +----------+ -----| 25 43/50 LINE MODE TOGGLE |---------| "Alt-M" |----- +-----------------------------+ +----------+ The expanded 43/50 line toggle will allow the user to switch back and forth from 25 lines to 43(EGA) or 50(VGA) - 15 - lines per display on monitors supporting such modes. When exiting the DS program the user is automatically placed back in the 25 line mode. Should the user exit the DS program while in the 43/50 line mode and subsequently reenter the program, the user will be placed back in the 43/50 line mode. +-----------------------------+ +------------+ -----| PRINT TAGGED FILES |-------|"P" "Alt-P"|----- +-----------------------------+ +------------+ The print tagged files option allows the user to send to the print program a maximum of 10 tagged files. This option simply sends to the user-specified "print" program the first 10 tagged files. The user specifies the desired print program through the use of the "Ctrl-E" (edit defaults) option. The edit defaults option ("Ctrl-E") contains a selection item that will instruct the program to automatically use the "alt-p" option even if the "p" option was selected if the amount of available memory is less than a specified value. The specified amount of memory is user tunable. Selecting 590k for the memory limit will force the program to always use the overlay option. Selecting 10k for the memory limit will prevent the overlay option from being used in place of the normal option. +-----------------------------+ +----------+ -----| RENAME FILE |---------| "R" |----- +-----------------------------+ +----------+ The rename option allows the user to rename the indicated file to a new name. +-----------------------------+ +----------+ -----| RESCAN DIRECTORY |---------| "Alt-R" |----- +-----------------------------+ +----------+ The directory rescan option will rescan the directory structure of the current default drive. This option may be necessary if you switch floppies in a floppy drive. It may also be used on a hard disk if you make or delete directories without using the directory modification (CTRL-D) option. This option will prompt the user whether they would like the subdirectories in the tree display indented by 3 or 4 characters from their parent directory. The default is the 3 character indent format, which provides for a more compacted tree display and may provide for more columns of files than would appear with a 4 character indent format. - 16 - +-----------------------------+ +----------+ -----| REFRESH SCREEN |---------| "CTRL-R" |----- +-----------------------------+ +----------+ The refresh screen option will allow the user to redraw the entire screen. This may become necessary should a DOS message like "Abort, Retry or Ignor" disrupt the screen. +-----------------------------+ +----------+ -----| SPLIT SCREEN |---------| "S" |----- +-----------------------------+ +----------+ The split screen option will allow the user to display 2 different directories on the screen at the same time. The directories can be on the same or different drives. Upon selecting the split screen option the top and bottom halves of the screen will display the same directory. The user can then change either the top or bottom display to a different directory and/or drive. To switch the active display from top to bottom or from bottom to top, use the '+' key. Selecting the "s" option when already in the split screen mode will cause the display to revert to the full screen mode. +-----------------------------+ +----------+ -----| SELECT & SORT |---------| "Alt-S" |----- +-----------------------------+ +----------+ The select & sort option allows the user to specify alternate sorts of the files in a directory. Additionally, it allows the user to filter out some files by allowing entry of a file match parameter to use rather than accepting the default file match parameter of "*.*". Upon program initialization the defaults are a filter of "*.*" with a sort by filename in ascending order. After selecting this option the user may change any/all the defaults. Depressing the space bar will toggle the sort option through the 5 sort types of no sort, name, extension, size and date. Depressing the up arrow or down arrow will toggle the sort direction to ascending or descending respectively. Entry of any other valid character will allow the user to change the file match parameter. Depressing the carriage return character after valid file filter parameter characters will change the file filter to the newly specified file filter. Depressing the carriage return character without any new file filter entered will change the file filter back to "*.*". The new sort and file select filter take effect upon termination of the sort/select option, upon pressing the ESC key. After terminating this option the new sort option will be displayed on the 1st of the 3 bottom status lines, right after the "Help = ?" message. Additionally, if the file - 17 - select filter is anything other than "*.*", it will be displayed above and slightly to the right of the sort type/direction in the display border. +-----------------------------+ +----------+ -----| TAG FILE |---------| "T" |----- +-----------------------------+ +----------+ The tag file option is used as a precursor to other options such as the copy tagged files option. When this option is selected, the current indicated file is set to reverse video and the next file becomes the current indicated file. +-----------------------------+ +----------+ -----| TAG ALL FILES |---------| "Alt-T" |----- +-----------------------------+ +----------+ The tag all files option allows the user to tag all the files in the current directory in preparation for execution of another option. +-----------------------------+ +----------+ -----| CONTROL TAGGING |---------| "Ctrl-T" |----- +-----------------------------+ +----------+ The control tagging option will allow the user to tag or untag files based on matches with filenames, dates and/or sizes. UP/DOWN Arrows - Will cycle through the selection options (name, date or size) the user will be selecting. LEFT/RIGHT Arrows - Will cycle through the selection criteria for a particular name, date or size option. <SPACE> - The space bar will toggle some of the criteria for name, date or size options. Normally the space bar will toggle between a specified filename, date or size and the "[other_screen]" option. The [other_screen] option indicates that the program should compare the file names, dates or sizes of the current directory with those on the "other screen" when the split/flip screen option has been previously selected. <TAB> - The TAB key will cycle through the month, day and year criteria of the date option. <+> - The plus key will increment the month, day or year criteria of the date option. <-> - The minus key will decrement the month, day or year criteria of the date option. - 18 - Once the user has setup the selection criteria for the name, date and size options the tagging or untagging of files based on such criteria is accomplished by selecting <CTRL-T> or <CTRL-U> respectively. The <CR> and F1 thru F8 keys function normally under this option, allowing the user to move to and enter different directories. Additionally the <Alt-T> and <Alt-U> options are enabled, allowing the user to tag or untag all the current files. The "Missing" criteria under the Name option always compares the files in the current directory against those in the "other_screen". If the "Missing" criteria is selected for the Name option then the "[other_screen]" cannot be selected for either the date or size options. +-----------------------------+ +----------+ -----| UNTAG FILES |---------| "U" |----- +-----------------------------+ +----------+ The untag option allows the user to untag a file that has been tagged by mistake. +-----------------------------+ +----------+ -----| UNTAG ALL FILES |---------| "Alt-U" |----- +-----------------------------+ +----------+ The untag all files option allows the user to untag all the files that are currently tagged. +-----------------------------+ +----------+ -----| UTILITY TREE DUMP |---------| "Ctrl-U" |----- +-----------------------------+ +----------+ The tree dump utility option will create a file "tree_x" where the "x" is the drive letter for the current drive. This file will be created in the root directory of the current drive and contain the tree structure diagram which is displayed on the left side of the DS display screen. +-----------------------------+ +----------+ -----| VOLUMN ID TOGGLE |---------| "Ctrl-V" |----- +-----------------------------+ +----------+ The volumn id toggle option will turn on/off the display of the default drive's volumn label. The volumn id will be displayed in the lower left corner of the display border when available and turned on. The default on start up is toggle off. - 19 - +-----------------------------+ +------------+ -----| EXECUTE FILE |-------|"X" "Alt-X"|----- +-----------------------------+ +------------+ The eXecute file option allows the user to execute the current indicated file if its file name extension is ".com", ".exe", ".bat", or ".bas". Files with a ".bas" extension are passed as a parameter to the execution of a file by the name of "basica.exe". Prior to the execution of any of these files, this option allows the user to enter command line arguments which are passed to the indicated program as it goes into execution. The "x" option executes the indicated program while the DS program stays resident in memory. The "alt-x" option will execute the indicated program while overlaying the DS program. Upon termination of the "alt-x" option the DS program will be reloaded from disk. The "alt-x" option is slower to reload/restart DS but useful in systems that are tight on memory. Upon reloading DS the "alt-x" option should retain the same current "indicated file"; however, all tagging of files will be lost. The edit defaults option ("Ctrl-E") contains a selection item that will instruct the program to automatically use the "alt-x" option even if the "x" option was selected if the amount of available memory is less than a specified value. The specified amount of memory is user tunable. Selecting 590k for the memory limit will force the program to always use the overlay option. Selecting 10k for the memory limit will prevent the overlay option from being used in place of the normal option. +-----------------------------+ +------------+ -----| SWITCH/FLIP SCREEN |-------| "+" |----- +-----------------------------+ +------------+ The Switch/Flip Screen option will allow the user to switch the active display from top to bottom or bottom to top if currently in the split screen mode. If the user is currently in a full screen mode but had previously been in a split screen mode, selecting '+' will flip the full screen mode to the other screen/display. When in the full screen mode if there exists another "flip" screen available, the drive letter of the other "flip" screen will be displayed in the directory display border just above the bottom 3 line status area. - 20 - +===========================+ ================| MACROS |================= +===========================+ Limited macro definitions may be supported thru the use of the following keys: Shift-F1 thru Shift-F9 (sF1 - sF9) Control-F1 thru Control-F9 (^F1 - ^F9) Alternate-F1 thru Alternate-F9 (@F1 - @F9) To display current macro definitions or to change definitions the following keys may be depressed: Shift-F10 Control-F10 or Alternate-F10 The user will then be presented with a display showing the current macro definitions for the appropriate shift, control or alternate function keys. The user will be allowed to select/highlight the desired function key and clear or reassign the defined macro for the selected function key. After changing any macros the user is prompted as to whether the changes should be made permanent. The following "special key sequences" may be used in the macro definitions: %F = Filename of the current "indicated file" will be inserted in the macro at this position. The filename INCLUDES the filename EXTENSION (ie: the characters after the period). %f = Filename of the current "indicated file" will be inserted in the macro at this position. The filename DOES NOT INCLUDE the filename EXTENSION. %d = Directory name (full pathname) of the current highlighted directory will be inserted in the macro at this position. %R = Return prompting will be required upon completion of the macro prior to returning to the main DS menu. The bottom of the screen WILL display a message prompting for the prompt character. %r = Return prompting will be required upon completion of the macro prior to returning to the main DS menu. The bottom of the screen WILL NOT display the prompting message. %i = Input from the user is expected prior to macro execution. The user will be prompted for this input. Be advised when using this option in - 21 - conjunction with either %t or %T that a "Σ" (Greek sigma) character will mark the position where the tagged filenames will be inserted. %T = Filenames of all currently tagged files will be inserted in macro at this position. The filename INCLUDES the filename EXTENSION (ie: the characters after the period). If the user desires to seperate the filenames with a specified character string then specify the string (max of 5 characters) between double quotes immediately after the %T. Example: %T"-+" Specifies that a minus sign followed by a plus sign seperates all the filenames in the macro. %t = Filenames of all currently tagged files will be inserted in macro at this position. The filename DOES NOT INCLUDE the filename EXTENSION. If the user desires to seperate the filenames with a specified character string then specify the string (max of 5 characters) between double quotes immediately after the %t. Example: %t"+ +" Specifies that a plus sign followed by a space followed by a plus sign seperates all the filenames in the macro. %1c = Execute the macro command only once. Some macro commands can be executed repeatedly (like pkarc) to accomplish thier mission; however, some programs (like link) can only be executed once to accomplish thier task. Use "%1" to indicate that the macro must execute only once. The "c" after the "%1" indicates what single character will be used to terminate all but the last line of input to the macro. Example: %1+ = "+" terminates all but the last line. %1\ = "\" terminates all but the last line. %O = Overlay the DS program upon executing the macro. This will recover the memory used by the DS program for use by the macro. Upon completion of the macro the DS program will be restarted or reloaded from disk. This option is slower returning to DS but may be useful in systems that are tight on memory. - 22 - %% = A "%" will be inserted in the definition at this position. Sample Usage: wp %F = Execute wordperfect and send it the filename (including .ext) of the current "indicated" file. dir /w %d %r = Do a wide directory listing on the current highlighted directory and require a prompting keystroke upon completion prior to returning to the main DS menu. del %f.* = Delete the current "indicated" file and all files with the same name but different filename extension. erase %i = Erase the file(s) the user will input. The macro will prompt the user for the input. lark %f = Execute the "lark" (list archive utility) program on the current indicated file. pkzip a newlib %T%O = Create a new archive file by the name of "newlib" and to this file add all the currently tagged files. The "pkzip" program which does the archiving may be executed repeatedly to archive all the specified files as DOS can only accept a maximum of 128 characters per command line. This macro will also overlay (%O) the DS program to conserve memory. DS will be reloaded/restarted upon completion of the macro. lib oldlib -+%t"-+";%R = Use the "lib" program to update an old file by the name of "oldlib" and insert into "oldlib" new copies of all the currently tagged files. The characters (-+) between the double quotes indicate the string to be used to seperate tagged file names. Also require (%R) a return key prompt on completion of the macro. link %t;%1+ = Link together into one program all the currently tagged files. Since the link program can only be executed once to do its job correctly (unlike repeated executions of pkarc to add to an arc file) the user must specify that the macro should only be executed once with the "%1" sequence. The - 23 - "+" following the "%1" sequence indicates that the "+" character will terminate all but the last of the input lines to the macro. PROGRAMMERS NOTE: The addition of the "%t", "%T", "%O", "%X", and the "%1c" options have greatly increased the number of combinations of special option keys in macros. With the limited time and resources available to the author, not all possible combinations have been thoroughly tested for compatability or integrity of operation. The user may have to tinker with the macro somewhat to get it to operate correctly. In particular I have noted that some macros will not work correctly if there are extra (not needed) spaces in the macro definition. Some macros (such as those using "%1" with "%T" or "%t") create a file "ds_macro.dat" in the "DS home" directory which is used as redirected input to the execution of the macro. The user may find it useful to review that file if problems with the macro execution occur. The "ds_macro.dat" file is also used with the "%T" and "%t" options when the "%O" (overlay) option is also specified. +===========================+ ================| EXIT OPTION |================= +===========================+ One exit option is available: F9 - Exit in the directory that is currently highlighted. +===========================+ ================| LICENSING & REGISTRATION |================= +===========================+ Directory Scanner (tm) Ver 4.00 Copyright (c) 1986-1990 All Rights Reserved by Nat Martino * A $15 shareware contribution is requested for using the program. * The author retains the sole right to sell the program. * The author grants users the right to copy and distribute the program within the following constraints: - All program files remain unaltered and are distributed en masse. - Only the original "non-cloned" version of the program with the startup/termination and drive change time delays is distributed. - No attempt is made to sell the program, or to make money from it or any modified version of it. - The program is not bundled with any other hardware or software transactions without the author's permission. - Recognized users' groups may charge a maximum $5 - 24 - duplication or distribution fee. * Continued use of the program (more than 2 weeks) by any individual, corporation or institution without a single user or site license is prohibited. * Single user licenses are obtained by sending in the $15 shareware contribution. * Corporations and other institutions (including government and educational) which desire using the program should refer to the "DS_SITE.LIC" file for site licensing information. * Special modified versions of the program can be created by the author for different system configurations or desires. Contact the author for details. +===========================+ ================| WARRANTY & DISCLAIMER |================= +===========================+ The author disclaims all warranties expressed or implied as to the quality or performance of this program. The author will not be held liable for any lost profits, lost savings or any other direct, indirect, incidental or consequential damages resulting from the use of this program. Your use of this program constitutes your agreement to this disclaimer and your release of the author from any form of liability or litigation. Selecting 590k for the memory limit will force the program to always use the overlay option. Selecting 10k for the memory limit will prevent the overlay option from being used in place of the normal option. - 25 -